\pard\tx7140\b0\fs28\li2100 INHERITS FROM ErrorInfo\
\fs16 \
\fs28 DECLARED IN Reply.h\
\fs16 \
\
\
\fs28 CLASS DESCRIPTION\
\fs16 \
\pard\tx3120\tx3620\tx4120\fs28\li2620 Reply is a subclass of the ErrorInfo class. Like it's parent class, Reply is designed to mainly be used as a return value from methods. Unlike it's parent, it does not confine itself to merely holding status information. Instead, it serves the dual purpose of returning status codes and messages, along with returning result values.\
\fs16 \
\fs28 Put another way, an obvious problem with the ErrorInfo class is that it sometimes becomes awkward when one wants to return an error status as well as potentially returning data. The Reply class provides both services in one object.\
\fs16 \
\fs28 A Reply object contains the same error information that an ErrorInfo ones does. It also, however, can contain one data value that is being returned.\
\fs16 \
\fs28 The Reply class understands a certain set of data types. One must subclass it to get more specialized types. The data types it understands are:\
char\
byte \
signed and unsigned short int\
signed and unsigned int\
signed and unsigned long int\
Cstring\
id\
When one creates a Reply object, one assigns it a value, specifying the data type. In all cases save the last, when this is assigned, a copy is made of the data. The receiver of the reply can then retrieve the data using an appropriate method, and free the Reply object.\
The data will be copied again for the user, so that when the Reply is freed, it can dispose of the data it holds appropriately. Note that it will
\i not
\i0 send a free message to the returned object.\
\fs16 \
\fs28 One can also pass `general' information with the Reply object. This is a four byte quantity which is not altered in any way by the Reply object, nor freed when it is destroyed itself. Thus, one can pass arbitrary pointers in this way within a thread. \
\fs16 \
\fs28 Using the class is much like using the ErrorInfo class, save that there are more initialization parameters.\
\fs16 \
\pard\tx7140\li2100 \
\
\fs28 INSTANCE VARIABLES\
\fs16 \
\pard\tx6640\tx9660\tx10180\i\fs28\fi-4040\li6640 Inherited from Object
\pard\tx3120\tx3620\tx4120\b0\fs28\li2620 Creates a new reply object with a full set of values for error code, text and kind, the data to be returned, and the kind of data. Data type codes are listed below.\
